home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / admin / fsmake.man < prev    next >
Encoding:
Text File  |  1991-06-01  |  7.2 KB  |  159 lines
  1. '\" Copyright 1989 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/admin/fsmake/RCS/fsmake.man,v 1.5 91/05/31 17:04:31 kupfer Exp $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS FSMAKE cmds
  13. .BS
  14. .SH NAME
  15. fsmake \- Create a file system on a disk partition.
  16. .SH SYNOPSIS
  17. .nf
  18. \fBfsmake -dev \fIdevice\fP -part \fIpartition\fP [\fIoptions\fR]
  19. .SH OPTIONS
  20. .IP "\fB\-dev\fI device\fR" 14
  21. \fIDevice\fP is the root name of a device, i.e. rxy0, rsd1, rsb0
  22. .IP "\fB\-part\fI partition\fR" 14
  23. \fIPartition\fP is a letter indicating a partition, i.e. a, b, c, d, e, f, g.
  24. .IP "\fB\-devDir\fI devDir\fR" 14
  25. \fIDevDir\fR is an alternate directory in which to find the device file
  26. named by concatenating \fIdevice\fR and \fIpartition\fR.  The default 
  27. directory name is ``/dev``.
  28. .IP "\fB\-initialPart\fI firstPartName\fR" 14
  29. \fIfirstPartName\fP is the name of the initial partition on the disk
  30. which contains basic disk geometry information.  The default is partition
  31. ``a''.
  32. .IP "\fB\-write\fR" 14
  33. Write the disk.  The default is to
  34. not write the disk.
  35. .IP "\fB\-overlap\fR" 14
  36. Overlap filesystem blocks across track boundaries. The default is to not overlap
  37. blocks.
  38. .IP "\fB\-ratio\fR" 14
  39. Ratio of Kbytes to file descriptors. The default is 4.
  40. .IP "\fB\-test\fR" 14
  41. Don't write to the disk. This is the default.
  42. .IP "\fB\-scsi\fR" 14
  43. Compute the disk geometry for a SCSI disk. The geometry will be laid out
  44. to maximize usable storage.
  45. .IP "\fB\-noscsi\fR" 14
  46. Compute the disk geometry for a non-SCSI disk. The geometry will be laid out
  47. to maximize transfer bandwidth.  The file system currently doesn't do 
  48. anything intelligent when laying out a file, so this option is probably
  49. not worth anything.
  50. .IP "\fB\-host\fI hostID\fR" 14
  51. Sets the host id field in the domain header. The default is to use the local
  52. host id if the device server is the local host, otherwise use the device
  53. server's id.
  54. \fIHostID\fR is either the name or Sprite id of the machine to 
  55. which the domain will be attached. 
  56. .IP "\fB\-boot\fI bootSectors\fR" 14
  57. Number of sectors in the root partition to reserve for the boot program.
  58. .IP "\fB\-repartition\fR" 14
  59. This option will change the partitioning of the disk.  
  60. DO NOT USE IF THE DISK CONTAINS A FILESYSTEM YOU WISH TO KEEP. 
  61. Use the
  62. \fB\-partdisktab\fR option to use the partitioning information in
  63. the disktab file, otherwise use the \fB\-size\fR option to set
  64. the size of the current partition.
  65. .IP "\fB\-partdisktab\fR" 14
  66. Use in conjunction with the \fB\-repartition\fR option to set the
  67. disk partitioning from the disktab file.
  68. .IP "\fB\-size\fI percentage\fR" 14
  69. Use in conjunction with the \fB\-repartition\fR option to specify
  70. the size of the current partition as a percentage of the total disk
  71. size. \fIPercentage\fR is an integer from 0-100.
  72. .IP "\fB\-reconfig\fR" 14
  73. Reconfigures the basic disk geometry.  
  74. DO NOT USE IF THE DISK CONTAINS A FILESYSTEM YOU WISH TO KEEP. 
  75. If the disk is a non-scsi disk then you must also specify
  76. the \fB\-configdisktab\fR option which causes the disk geometry
  77. to be read from the disktab file.  If the disk is a scsi disk
  78. then you may omit the \fB\-configdisktab\fR option.
  79. \fIFsmake\fR will then invent a configuration that minimizes wasted
  80. disk space.
  81. .IP "\fB\-configdisktab\fR" 14
  82. Use in conjunction with the \fB\-reconfig\fR option to set the
  83. disk configuration (geometry) from the disktab file.
  84. .IP "\fB\-disktabName\fI filename\fR" 14
  85. Specify the disktab file.  The default is \fI/etc/disktab\fR.
  86. .IP "\fB\-disktype\fI type\fR" 14
  87. Specify the type of disk.  This \fItype\fR parameter must
  88. be the type of disk found in the disktab file.  This option
  89. must be present in order to use the disktab file.
  90. .IP "\fB\-labeltype\fI type\fR" 14
  91. Type of label to write on the disk.  The default is to write whatever
  92. label is appropriate for the machine on which \fBfsmake\fR is run.
  93. .IP "\fB\-dir\fI directory\fR" 14
  94. Copy the specified directory into the newly created filesystem.
  95. .BE
  96.  
  97. .SH DESCRIPTION
  98. .PP
  99. \fBFsmake\fR will create a Sprite filesystem on a partition. 
  100. It has a large number of options and is intended to be invoked from
  101. a shell script.
  102. \fBFsmake\fR's basic function is to create a filesystem out of an
  103. entire partition by initializing the 
  104. the file descriptor
  105. bitmap, data block bitmap and domain header, and creating
  106. the root and lost+found directories.
  107. If you desire you can copy a directory tree into the new filesystem
  108. via the \fB\-dir\fR option.
  109. The \fB\-dir\fR option is intended to be used under UNIX.
  110. If you need to copy stuff into the new filesystem under Sprite
  111. use the \fBupdate\fR command.
  112. The rest of the options are more complex and probably not used often.
  113. The disk configuration, such as sectors per track, tracks per cylinder,
  114. etc, can be set using the \fB\-reconfig\fR option.
  115. Don't use this option if the disk contains anything you want to keep,
  116. since it may goof up the size and location of the disk partition.
  117. If you don't specify the \fB\-configdisktab\fR option then
  118. \fBfsmake\fR will make up a configuration that minimizes wasted disk
  119. space.  This only works under Sprite and on SCSI disks.
  120. .pp
  121. The \fB\-repartition\fR allows you to change the partitioning of the disk.
  122. The \fB\-partdisktab\fR will set the partitioning from the disktab file.
  123. Once again, don't use this option if there is valuable stuff on the disk
  124. since you may lose it.
  125. If you don't use the \fB\-partdisktab\fR option then you have to use the
  126. \fB\-size\fR option to set the size of the current partition as a
  127. percentage of the total disk size. 
  128. \fBFsmake\fR will adjust the start of all paritions that "follow"
  129. the current one on the disk.
  130. Note that \fBfsmake\fR assumes an ordering on the partitions, ie
  131. 'a' starts at the beginning of the disk, 'g' follows 'a', 'f' follows
  132. 'e' which in turn follows 'd' which in turn follows 'a'. 'c' is the whole
  133. disk and 'b' is not used. 
  134. If you want to change the size of a bunch of partitions then run \fBfsmake\fR
  135. on the patritions in alphabetical order.  That should do the right thing.
  136. .pp
  137. The \fB-ratio\fP option allows you
  138. change the ratio of file system blocks to file descriptors.
  139. Non-SCSI disks can have their file system blocks overlap track
  140. boundaries by specifying the \fB-overlap\fP option.  This packs
  141. more blocks per cylinder.
  142. .SH Fsmake on UNIX
  143. .pp
  144. The \fBfsmake\fR command can be run on a UNIX system to create a 
  145. Sprite filesystem.
  146. There are several differences in functionality. 
  147. First, \fBfsmake\fR cannot make up a configuration for the disk.
  148. The configuration must be set from the disktab file.
  149. Second, the \fB\-dir\fR option uses a special mechanism for creating
  150. Sprite devices.  If \fBfsmake\fR comes across a file with the suffix
  151. "SPRITE_DEV" it is assumed to be a placeholder for a Sprite device.
  152. The contents of the file specify the device server, major number and
  153. minor number.  Lines that are blank or begin with '#' are ignored.
  154. The file should contain one line with three integers -- the device
  155. server SpriteID, major number (device type), and minor number (device unit).
  156. .SH KEYWORDS
  157. filesystem
  158.  
  159.